home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 2 / ACE CD 2.iso / FILES / UTILS / AMOSPRO4.DMS / in.adf / Extensions / Extension_ReadMe.Asc < prev   
Encoding:
Text File  |  1992-09-28  |  5.1 KB  |  118 lines
  1. ______________________________________________________________________________
  2. ..............................................................................
  3. ...................................................................2222222....
  4. ................................................................22222222220...
  5. ...................................................222........222222.....222..
  6. ..............................................2202222222222..22000............
  7. ..................................22000.....20222222222200000200002...........
  8. .................................2002202...2222200222.220000000200000000022...
  9. ....................220002......22222200..2200002.......2200000...20000000000.
  10. ....................22222202....2220000022200000..........200002........200000
  11. .....200000.........2222200000222200220000000002..........200002........20000.
  12. .....00222202........2220022000000002200002000002........2000002000020000000..
  13. ....2222200000.......220002200000002.2000000000000222222000000..2000000002....
  14. ....220000200002......20000..200002..220000200000000000000002.......22........
  15. ...2220002.2200002....220002...22.....200002..0000000000002...................
  16. ...220000..222000002...20000..........200000......2222........................
  17. ...000000000000000000..200000..........00002..................................
  18. ..220000000022020000002.200002.........22.......______________________________
  19. ..0000002........2000000220022.................|
  20. .200000............2002........................| AMOSPro Extension System
  21. .200002........................................| 23/09/1992
  22. 220002.........................................|______________________________
  23. ______________________________________________________________________________
  24.  
  25. This information is valid for AMOSPro V1.0. It may have changed with older
  26. version of AMOSPro. Please ask for the latest update.
  27. ______________________________________________________________________________
  28.  
  29.  
  30. Hello everybody! François typing on the keyboard to give you more information
  31. on the AMOSPro Extension system.
  32.  
  33. 1. Starting an extension from scratch.
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35. You have never created an extension before and you want to make
  36. your new instruction set.
  37.  
  38. No problemo. All you need is:
  39.  
  40.     - An assembler (GenAm2 or 3 preferably)
  41.  
  42.     - All the include files in this folder
  43.  
  44.     - Skill, and patience. All the necessary explanations
  45.       are given in the file |Music.s.
  46.       I suggest that instead of starting an extension from scratch,
  47.       you begin by changing one that already exists. A simple
  48.       one like |Compact.s is a good example. This way, all the crucial
  49.       inits are already provided.
  50.  
  51.     - Note, you can easily debug you code by placing an "Illegal" in
  52.       your code. This will stop AMOSPro and you can then press [Amiga]+[A]
  53.       to flip back to the workbench display. This works because Amiga-A is
  54.       handled by interrupts.
  55.  
  56.  
  57. 2. Transfering an AMOS1.3 extension.
  58. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  59. First of all, sorry for changing the format of the equates file,
  60. and forcing you to re-assemble your code. I have had to change things
  61. so that I could implement all the nice features of AMOSpro. I have also
  62. progressed a lot since the first AMOS, and I have discovered ugly things that 
  63. NEEDED to be removed.
  64.  
  65. On the bright side, 99.9% of change is a simple re-assemble of your code using
  66. the new equates, and then it should work.
  67.  
  68. What exactly has changed?
  69.  
  70.     - The equates, as mentioned before. Just use "Include |AMOS_Include.s"
  71.  
  72.     - The RJsr calls to the main AMOSPro function library.
  73.       The new ones are much better, and more powerful. For example
  74.       all the necessary bank handling functions are re-written.
  75.       You can now call the file selector from within your extension.
  76.       You must read the "|Music.s" file to have the list of
  77.       all available instructions.
  78.  
  79.     - WARNING: L_Bnk.OrAdr uses D0 to input the number of the 
  80.       bank, and not D3 any more! Check your code if you use it.
  81.  
  82.     - The title format has also changed: the "10" character is
  83.       no longer needed. You can also have AMOS call your own
  84.       title routine if you want.
  85.  
  86. The AMOSPro compiler will accept your extension code.
  87.  
  88. I can inform you now, when new Commodore machines are out, 
  89. you (and I) will have to create new extension code to use the new 
  90. features. But, that's the way it goes.
  91.  
  92.  
  93. 3. What number should you use for your extension.
  94. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  95. Please use a number from 26 and downwards. Official AMOSpro
  96. extensions are from 1 upward. This way yours and ours will
  97. never collide!
  98.  
  99. The extension number is CRUCIAL for your code to work. AMOSPro
  100. will refuse to boot if the number of the extension in the list
  101. is not the same as the one returned by the code.
  102. So check your code.
  103.  
  104. To register an official AMOS Extension contact Richard Vanner at
  105. Europress Software. He will confirm the numbers validity and ensure
  106. future extensions don't collide.
  107.  
  108.  
  109. 4. Why do I use a "|" character before all my source names?
  110. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  111. Hehehe. Doing this ensures all the source code file are automatically
  112. sorted at the end of the file selector display. Faster and easier to 
  113. locate!
  114.  
  115.  
  116. Well, that's all for now, have fun. Francois.
  117.  
  118.